home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / fractal / mndlplt2.lha / Docs / Mandelplot.Doc < prev    next >
Encoding:
Text File  |  1992-09-02  |  6.5 KB  |  126 lines
  1.     
  2.                    Mandelplot V2.4                 (17/8/93)
  3.                ---------------
  4.             
  5.         Documentation for Unregistered version
  6.         --------------------------------------
  7.         
  8.  Important:  This documentation covers only the very simplest features of the
  9.  ---------  program. For complete documentation you must register (see
  10.           registration.doc)
  11.           
  12.  Introduction:  Mandelplot is a fractal generation program. Unlike almost all
  13.  ------------  other fractal programs for the Amiga, Mandelplot doesn't just
  14.    produce 2D images of the Mandelbrot set - Mandelplot was inspired by
  15.    'Fractint' on the PC and like Fractint it is a complete fractal package-
  16.    You can generate many different fractal types, view them in 2D or 3D,
  17.    make animations, and even design your own fractals with the formula editor.
  18.    Mandelplot is also the fastest program of its kind on the Amiga- all the
  19.    fractal algorithms have been individually written in highly optimised
  20.    machine code. Eg the basic Mandelbrot set takes just over 5 seconds to
  21.    generate on an old 1.2 1MB A500 and only 1.4 seconds on my 6MB 1200.
  22.    
  23.  Installation:  Mandelplot should run on any Amiga with at least 1MB memory 
  24.  ------------  although it has only been tested on a 1MB A500 (from floppy)
  25.    and on a 6MB A1200 (3.0) (from a 60 MB HDD).
  26.     Running from Floppy or hard disk: The main file 'Mandelplot' must be 
  27.    present in a directory assigned as 'Mandelplot:' or must be in the root
  28.    directory of a disk named 'Mandelplot'. The fonts 'helvetica' and 'Peridot' 
  29.    must be present in a directory assigned as 'fonts:'. These are the only
  30.    requirements for the program to run, although the following directories/
  31.    assigns should be present:
  32.    
  33.    Mandelplot:FraFile        } contains fractal pictures
  34.    Mandelplot:IFS        } contains data files for IFS fractal type
  35.    Mandelplot:User_Functions    } contains formula files
  36.    S:                } preferences file written here
  37.    
  38.  Getting Started: The program should have been supplied to you on an auto- 
  39.  ---------------  booting disk that loads to a workbench screen. To start it 
  40.    up, simply double click on the disk icon, then on the Mandelplot icon.
  41.    Press the left mouse button to skip the information window that appears,
  42.    and the program will begin to draw a mandelbrot set fractal. After a couple
  43.    of seconds, the image will be complete, and the main menu will appear.
  44.    You can use the right mouse button to toggle this menu on/off or select an
  45.    option from the menu by clicking in the box to its right with the left
  46.    button.
  47.    
  48.   Interrupting fractal generation: Press the left mouse button at any time
  49.    when a fractal is being drawn to interrupt this process and bring up the
  50.    main menu.
  51.    
  52.   Zooming in on a fractal image: Use the right button to close the menu screen,
  53.    then drag a zoom box over an interesting area of the fractal with the left
  54.    mouse button. Press space to redraw this area at full screen size. 
  55.    
  56.   Generating a new fractal image: Bring up the menu with the right button. 
  57.    Select the 'Select fractal type' option to bring up a list of the available
  58.    fractal types. Simply select the desired fractal type and it will be drawn
  59.    on the screen. Only those types in white are selectable on this version. 
  60.    The others are only available on the full version, which you can obtain
  61.    by registering (see registration.doc).
  62.    
  63.   Increasing the detail level: When you have zoomed some way into a fractal,
  64.    the image may appear to lack detail and have many black areas. This 
  65.    probably means that you need to increase the detail level. Select 'Change
  66.    detail level' from the main menu, and double the value of 'Max iters'. This
  67.    should reveal new detail, but will increase the generation time.
  68.    
  69.   Loading/Saving fractal files: Mandelplot loads/saves fractal images as a 
  70.    standard DPaint compatable IFF ILBM file with a separate data file 
  71.    containing all the fractal information. This extra file enables you to 
  72.    reload a saved image and redraw it/zoom into it etc. To load or save an
  73.    image, select the appropriate option from the main menu and enter the
  74.    file name and path into the file requester. 
  75.    
  76.   Changing resolution: The default mode for Mandelplot is low-res, 32 colours.
  77.    All of the standard Amiga screen modes (not AGA or ECS) are supported, and
  78.    can be selected using the 'Select screen mode' option. Support for the AGA
  79.    chipset will be included in the very near future, but will only be available
  80.    to registered users.
  81.    
  82.   Animation: Generating nice animations is easy with Mandelplot. Generate and
  83.    save two different .FRA files to form the first and last frames of the
  84.    animation, set the total number of frames, and Mandelplot will
  85.    automatically generate and save the in between images. Eg. if the first
  86.    frame was the mandelbrot set and the last a zoom in on the mandelbrot
  87.    set, the result will be a collection of images zooming smoothly into the
  88.    mandelbrot set. To make an animation, these frames must be loaded into
  89.    DPaint III or similar and played as an anim from there. Mandelplot has
  90.    an intelligent animation routine and will smoothly vary ANY parameter that
  91.    varies between the first and last frames, so you can easily generate:
  92.    zoom ins, rotating 3D fractals, warping fractals, and many others!
  93.    
  94.    Floppy disk users: Because of the space needed for animations, adopt this
  95.    procedure: format a floppy, save the first & last frames on this disk, and
  96.    also select this disk as the output path for the anim frames. This will
  97.    ensure that sufficient room is available.
  98.    
  99.    NOTE - in this version, anims are restricted to <=16 frames in length. This 
  100.    resriction is of course not present in the complete version.
  101.    
  102.   Other options: There are loads of features which are not explained in this
  103.    document- the palette editing options/ colour control/ the 'Auto' mode/
  104.    different drawing modes/ 3D options/etc... if you wish to use these 
  105.    features, you will either have to figure out how to use them yourself 
  106.    or register, in which case you will receive the complete documentation. 
  107.    
  108.   --------------------------------------------------------------------------
  109.    
  110.   Credits
  111.   -------
  112.    
  113.    The fractal routines and algorithms for 'Mandelplot' was written 
  114.    using HiSoft's excellent Devpac 3, and the user interface was written
  115.    using Amos Pro and the Amos Pro Compiler. 
  116.    Thanks to the Stone Soup Group for writing the superb (for a PC program)
  117.    'Fractint' which was the inspiration for Mandelplot.
  118.    
  119.    
  120.    
  121.    
  122.      
  123.   
  124.    
  125.    
  126.